iRestore Read Me File Version 1.0 11/ 9/1998 ============================================================================== NOTE: The shareware version of iRestore is limited to restoring files of less than 2048 bytes. Please register IRBACKUP to receive the full unlimited version of iRestore. =============================================================================== What's new from version 0.2? Lots! Here is a list of the new features: 1. A log is now kept listing what files were and were not restored and why. 2. Restore only missing files. 3. Restore only missing or newer files. 4. Check for available space before restoring each file. 5. Partial restore by directory/subdirectory. 6. Selective restore by file name/type with wildcards. 7. Restore to a different directory then the original. 8. '/Test' option to see a list of what files you have selected for restore and where they will go on your Psion. Done without Psion. I purchased the registered version of iRestore 0.2 how do I upgrade to the registered version of 1.0? You are entitled to a free upgrade to version 1.0. The version of irNFS that runs on your Psion is the same as used on 0.2 so you can start testing the new features by just running the DOS shareware program. If you like what you see just send me a note with your current e-mail address (in case it has changed since you registered) and I will ship you out the new registered version. What does iRestore do? iRestore allows you to restore a previously saved copy of your Psion's files and directory structure from your PC back to your Psion. iRestore is designed to restore files saved by IRBACKUP. The required directory characteristic is that a valid Psion drive letter (A,B,C, or M) be the start of the Psion directory structure. C:ÄÂÄDOS ÃÄPSION ³ ÀÄÄÄÄÄÄÄÂÄPSIWIN ÃÄTEMP ÃÄBACKUP ÚÄÄ Starting directory for restore ÃÄWINDOWS ³ ÀÄÄÄÄÄÄÄÂÄJAN V ÃÄSDK ÃÄFEB ³ ÀÄÄÄÄÄÄÄÂÄM ÃÄMAR ÃÄA ³ ÀÄÄÄÄÄÄÄÂÄAGN ÀÄB ÃÄAPP ÃÄDAT ÃÄIMG ÃÄOPD ÃÄOPL ÃÄSPR ÃÄWDR ÃÄWLD ÀÄWRD To restore the complete file structure shown above you would use the following command line: iRestore 2 c:\psion\backup\feb\a a (where 2 is your Infrared comport number) If you were alread in the 'feb' directory and had used 'set IRPORT=2' then you would only need to enter: iRestore a By default iRestore only restores missing files. If the file exists it will not be overwritten. If you wish to restore files that are either missing or overwrite older files with newer ones from your PC then add the /NEWER directive. If you wish to force a complete restore even if the PC version is older than the Psion version then add /ALL. What programs make up iRestore? There are two parts to iRestore. The first is the program that runs on your PC and is named iRestore.com. This program contains all the logic that makes up the restore function. The second part is a general purpose file server program that runs on your Psion and is named irnfs.opa. This program manages the Infrared Link on your Psion and responses to requests made by the PC program for file access. It is the program irnfs.opa that is actually creating the directories and writing files at the direction of iRestore. Where is irnfs.opa kept and how do I get it on my Psion? The program irnfs.opa is contained within the iRestore.com program. Also included inside iRestore.com is a transfer program that speaks native Psion 3c/Siena Infrared protocol. You transfer irnfs.opa to your Psion by first placing your Psion in Infrared file receive mode (check your Psion manual for information on how to receive a file from another Psion). You then type the following line at the DOS prompt: iRestore 2 send (where 2 is your Infrared comport number) The native file transfer code built into iRestore will fool your Psion into thinking it is receiving a file from another Psion. The irnfs.opa program currently used is version 0.9 so if you already have this version on your Psion from installing one of my other programs you do not need to send it again. If you have an older version of irnfs.opa on your Psion you will need to delete it first before receiving this newer version since the native Psion protocol does not allow a file to be overwritten. Can I specify what directories iRestore restores to my Psion? Yes. After the drive letter you can add the directory/subdirectory you would like restored. To restore only files in the Agenda directory you would enter: iRestore m\agn If you wanted to restore them to a different drive you would enter: iRestore m\agn a: To restore them to a different directory you would enter: iRestore m\agn temp or iRestore m\agn a:\temp\agn Can I specify the type of files to be restored? Yes. You can add a file specification after the drive/path name. VERY IMPORTANT !!!!!!!!!!!!!!! The current version of IRBACKUP does not archive files it finds in your PC directory but are no longer on your PSION when it does a backup. This means that your PC backup directories may contain many files that are no longer on your PSION. If you run iRestore it will attempt to restore all the files it finds in the backup directory which could be more than your Psion has space for. The current solution is to move those files that have been backed-up but are no longer needed on your Psion to a different directory. Move any files you no longer wish restored out of the specified source directory structure to an archive directory structure before starting a restore. At some point in the future I hope to upgrade IRBACKUP to automatically do this archive function. But I can not give any target date at this time. Does iRestore erase any files or directories on my PSION? No. iRestore only addes to or overwrites files with the ones being restored. For example if you have a directory with files that were never backed up then they will still be there after the restore opertion. You will need to first reformat or erase (if m: drive) your Psion drive if you wish to only have the files that restore sends over. How is the data protected? Each data block transferred is protected by a 16 bit CRC check code (x^0+x^5+x^12+x^16) and a 16 bit sequence number. What baud rate is used to send the files? The default speed is 19,200 for both irNFS and iRestore. Baud rates up to 115,200 are possible given your hardware's capabilities. Be sure to set both irNFS and iRestore to the same speed. I currently use 57,600 baud for my Siena. What IR hardware works with iRestore? This version now supports the Adaptec AIRport 1000/2000, Actisys IR220L, Redeye, Jeteye, and Tekram external adatpers. How can I permanently set the IR port? The IR port can be permanently set by setting the environment variable IRPORT. The syntax is "set IRPORT=x" or "set IRPORT=xxx:i" depending on whether you have a standard or non-standard IR port. This can be typed at the DOS prompt for testing and then added to your AUTOEXEC.BAT. Once set you no longer need to supply it on the command line when running iRestore. To do a complete backup of the m: drive to the subdirectory myfiles just type: iRestore 2 c:\psion\backup\feb\a a How can I select a different IR link speed? The IR link speed can be changed from the default speed of 19,200 baud by setting the environment variable IRSPEED. The syntax is "set IRSPEED=x" where x can be 9600,19200,38400,57600, or 115200. Only the first two digits of the speed value are actually checked so IRSPEED=11 selects 115200 baud and IRSPEED=96 selects 9600 baud. Not all baud rates are available on some external IR adapters. The IRSPEED value does not affect the IR link speeds used by the SEND option unless the lowest link speed (9600) is selected. In this case the SEND option link speed is also limited to 9600 baud. The SEND option normally uses 9600 baud to locate the PSION and then steps up to 19,200 for the actual OPA file transfer. Be sure to select the same link speed when starting the Psion IRNFS.OPA server code as you specified with the IRSPEED variable. Where can I get the latest version? A web site has been setup at: http://www.geocities.com/SiliconValley/Lakes/3947 It has the latest version of iRestore plus access to other Psion IR programs and information about current and future plans. IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT IMPORTANT ============================================================================== It is highly recommended that you do a test restore with some sample files as outlined above before doing a complete restore. ============================================================================== DISCLAIMER Use this software at your own risk. I will not be held responsible for any damage to you, your machine and/or your information as a result of using iRestore. ============================================================================== Requirements: PSION: Siena, 3c PC : x86 with IRDA compliant IR port Operating System: DOS, Windows 3.1, WIN95 (MS-DOS mode only) Files in this package: iRestore.COM Program that restores files to your Psion. README.IRS This file. Installation: Load iRestore.COM on your PC then type "iRestore com# send" to load the ifnfs.opa program onto your Psion. Replace "com#" with the number of your Infrared serial port (ie 1,2,3,4 or port#). Install the program on your Psion system screen using the nornal Psion-I key sequence. Running iRestore. Be sure to set the IR Link to run at HIGH power. From the system screen press Psion-L select Infrared then Power setting to HIGH. Now startup the irNFS.opa program and point your Psion Infrared window at your PC's Infrared window. Then type iRestore followed by the COM number for your IR port, the name of the starting directory of the restore (must end in valid Psion drive letter), and last specify the Psion drive to restore to (A,B,C,M). Your can restore to a different drive then where the data came from. If a file transfer gets hung up you can terminate the iRestore by holding down both shift keys on the PC. Restored files will have the original date and time preserved. Syntax of iRestore.com: iRestore < com 1,2,3,4 > < Psion > {} Examples: iRestore 2 psion\m m (Restore to Psion m drive) iRestore 3E8 c:\backup\a a (Restore to Psion a drive) iRestore 2 send /airport (Send irnfs.opa file to Psion, AIRport IR Adp) You can set the environmet variable IRPORT to avoid having to type the IR port information on the command line each time. At the DOS prompt type: "set IRPORT=2" or "set IRPORT=3e8" (Of course use the correct values for your IR port.) You can also use the environment variable IRTYPE to avoid having to type the adapter type. At the DOS prompt type: "set IRTYPE=Redeye" (replace Redeye with your adatper type). Aborting the program: To abort a restore on the PC just hold down both the left and right shift keys for a few seconds. Then after the statistics have been displayed press any key. To abort the PSION IRNFS.OPA program press Psion-Esc or go to the system screen and highlight IRNFS then press the 'Del' key. How can I tell if my IR port is working: If you have a camcorder get it out and go into record standby mode and look through the viewfinder. You should see a flashing light coming from the IR window on your PSION or Notebook when they are sending. When the iRestore program is running it makes the PC the master and it starts sending looking for the PSION to respond. Look for a flashing light from your PC's IR window (you don't even need the PSION running at this point). You should see a flash about once a second as the PC looks for the PSION. Next startup your PSION and place it so you can watch its IR window for the return response. Improvements: If you have any suggestions for improvements please email me with them. Registration: If you find this program useful please register your copy. Registered users will receive an unrestricted version without the 2KB limit that restores any size file as well as the backup program. Registration is now available online through RegNet ($23 = $15 + $7 RegNet handling fee). To register online go to: http://www.reg.net/product.asp?ID=840 Jim Pollock History: 0.2 8/11/1997 First release 1.0 11/09/1998 Add support for Tekram external IR Adapter Improved ability to run in Windows 95/98 DOS Window. Stopped using Interrupts. Fix bug that stopped restore if an attempt was made to restore the file irNFS.opa. The program would stop after restoring the remainder of the directory \APP or any subdirectory within \APP. ===========================End of Readme======================================